Move annotations channel changelog entries to 0.4.0#262
Merged
Conversation
The annotations channel (state types, `annotations/set|removed|entrySet| entryRemoved` actions, `MessageAnnotationsAttachment`, `SessionSummary.annotations`) was documented under `## [0.3.0]` in every CHANGELOG and mapped to `'0.3.0'` in `ACTION_INTRODUCED_IN`, but it never shipped in `spec/v0.3.0`. Its sources first appear at the `spec/v0.4.0` tag, so the channel actually shipped in 0.4.0. Move the annotations bullets from `[0.3.0]` to `[0.4.0]` across all six changelogs and correct the registry's introduced-in versions to `0.4.0`, so `isActionKnownToVersion` no longer advertises annotations to peers negotiating `0.3.0`. Fixes #222 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
joshspicer
approved these changes
Jun 24, 2026
yucm002-ops
pushed a commit
to yucm002-ops/agent-host-protocol
that referenced
this pull request
Jun 25, 2026
The annotations channel (state types, `annotations/set|removed|entrySet| entryRemoved` actions, `MessageAnnotationsAttachment`, `SessionSummary.annotations`) was documented under `## [0.3.0]` in every CHANGELOG and mapped to `'0.3.0'` in `ACTION_INTRODUCED_IN`, but it never shipped in `spec/v0.3.0`. Its sources first appear at the `spec/v0.4.0` tag, so the channel actually shipped in 0.4.0. Move the annotations bullets from `[0.3.0]` to `[0.4.0]` across all six changelogs and correct the registry's introduced-in versions to `0.4.0`, so `isActionKnownToVersion` no longer advertises annotations to peers negotiating `0.3.0`. Fixes microsoft#222 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Fixes #222.
The annotations channel was documented under
## [0.3.0]in all six CHANGELOGs (root + Rust/Kotlin/Swift/TypeScript/Go) and mapped to'0.3.0'intypes/version/registry.ts, but it never shipped inspec/v0.3.0. Thetypes/channels-annotations/sources first appear at thespec/v0.4.0tag (wherePROTOCOL_VERSIONis0.4.0), so the channel actually shipped in 0.4.0. (annotations/updatedwas already correctly attributed to 0.4.0.)Changes
AnnotationsState/Annotation/AnnotationEntry/AnnotationsSummary, theannotations/set|removed|entrySet|entryRemovedactions,MessageAnnotationsAttachment,SessionSummary.annotations, reducer/snapshot slots) from[0.3.0]→[0.4.0].types/version/registry.ts: correctedACTION_INTRODUCED_INforAnnotationsSet/Removed/EntrySet/EntryRemovedfrom'0.3.0'→'0.4.0', soisActionKnownToVersionno longer reports annotations as available to peers negotiating0.3.0.### Fixedentries under[Unreleased]in the root and TypeScript changelogs for the registry correction. The introduced-in map is TypeScript-only (not mirrored into the other clients), confirmed bynpm run generateproducing zero generated diffs.Verification
npm run generate→ no generated-file changes.npm run test→ 267 passed, 0 failed (typecheck, eslint,verify:release-metadata,verify:changelog, 100% reducer branch coverage).